Add TypeScript SDK and examples for the Skills Extension SEP#71
Open
Add TypeScript SDK and examples for the Skills Extension SEP#71
Conversation
This was referenced Apr 13, 2026
This was referenced Apr 13, 2026
Reference implementation demonstrating the Skills Extension SEP with: - skill:// resource convention with multi-segment paths - Extension declaration (io.modelcontextprotocol/skills) via SEP-2133 - SEP-2093 shims: resources/metadata, URI-scoped resources/list, per-resource capabilities via _meta - SDK with server-side discovery/registration and client-side wrappers (listSkills, readSkillUri, fetchSkillMetadata, READ_RESOURCE_TOOL) - 4 sample skills: 2 single-segment, 2 multi-segment under acme/ - End-to-end client demo exercising all 7 features Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Each shim function now has a TODO with the specific PR link for when/if it can be removed. Uses "if" not "when" since the upstream PRs are drafts not guaranteed to merge. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
ASCII diagrams showing: overall system structure, URI anatomy, discovery flow, SDK-to-protocol mapping, and what's permanent SEP design vs temporary SDK shims. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Align the reference implementation with PR #69's SEP spec, which defines skill://index.json as the primary enumeration mechanism and requires zero protocol dependencies beyond resources/read. Added: - skill://index.json well-known discovery index (Agent Skills format) - generateSkillIndex() server-side, listSkillsFromIndex() client-side - SkillIndex/SkillIndexEntry types and INDEX_JSON_URI constant - 53 tests across URI utilities, index round-trip, and client parsing Removed (SEP-2093 features not in the SEP): - resources/metadata handler and fetchSkillMetadata() - Scoped resources/list(uri=...) and listSkillsScoped() - Per-resource _meta capabilities on all resource registrations - ResourceCapabilities/ResourceMetadataResult types - Zod schemas and RequestHandlerRegistrar interface Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Bump @modelcontextprotocol/sdk from 1.27.1 to 1.29.0, which includes native extensions capability support (typescript-sdk#1811, backport of #1630) and the missing size field on ResourceSchema (#1575). - Replace private _capabilities hack in declareSkillsExtension with the SDK's native registerCapabilities API - Add size field to SKILL.md resource metadata in registerSkillResources - Keep ServerInternals as a deprecated alias for backward compatibility - Update README shims table to reflect resolved workarounds Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
olaservo
force-pushed
the
add-sep-example
branch
from
975e8d1 to
7a6a182
Compare
olaservo
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
TypeScript SDK and working examples for the Skills Extension SEP draft. Zero protocol dependencies beyond
resources/read.What it demonstrates
skill://resource convention — multi-segment paths with organizational prefixes (skill://acme/billing/refunds/SKILL.md)skill://index.json— well-known discovery index following the Agent Skills formatio.modelcontextprotocol/skillsvia native SDKregisterCapabilities(v1.29.0)listSkills(),listSkillsFromIndex(),readSkillUri(),readSkillContent(),readSkillManifest(),READ_RESOURCE_TOOLWhat's included
typescript/sdk/@modelcontextprotocol/ext-skills)examples/skills-server/skill://resourcesexamples/skills-client/examples/sample-skills/acme/examples/README.mdSEP compliance
Verified point-by-point against PR #69:
io.modelcontextprotocol/skillsincapabilities.extensionsskill://URI scheme withSKILL.mdexplicit in all URIsnameskill://index.jsonwith$schema,type: "skill-md",name,description,urlread_resourcetool schema matches SEP (server + uri params)skill://{+skillFilePath}for supporting filessizefield on SKILL.md resources (SDK v1.29.0)SDK status
Uses
@modelcontextprotocol/sdkv1.29.0 (latest stable). Prior workarounds for extensions capability (_capabilitiespatching) have been replaced with the nativeregisterCapabilitiesAPI. Remaining shims are tracked in the README table.Test plan
cd typescript/sdk && npm install && npm run build && npm test— SDK compiles, 53 tests passcd examples/skills-server/typescript && npm install && npm run build— Server compilescd examples/skills-client/typescript && npm install && npm run build— Client compilesnode examples/skills-client/typescript/dist/index.js— 6-step demo runs end-to-endskill://index.jsonreturns all 4 skills in Agent Skills discovery format🦉 Generated with Claude Code